home *** CD-ROM | disk | FTP | other *** search
/ Network Support Library / RoseWare - Network Support Library.iso / btrieve / xtros2.exe / XTROS2.DOC < prev    next >
Text File  |  1993-12-14  |  39KB  |  1,113 lines
  1. NOVELL TECHNICAL INFORMATION DOCUMENT
  2.  
  3. DOCUMENT PROCESSING INFO: NOVLIB LIB7
  4. TITLE: Xtrieve OS/2 v4.11 patch E
  5. DOCUMENT ID:
  6. DOCUMENT REVISION: A
  7. DATE: 13DEC93
  8. AUTHOR: MGAINES
  9. ALERT STATUS: Yellow
  10. DISTRIBUTION: Public
  11. INFORMATION TYPE: Issue
  12. README FOR: XTROS2.EXE
  13. NOVELL PRODUCT CLASS: Database Products
  14. NOVELL PRODUCT and VERSION: Xtrieve PLUS 4.1x
  15. CATEGORY: OS/2
  16. ABSTRACT: XTROS2.EXE contains the OS/2 environment patch release E for Xtrieve PLUS v4.11 programs and utilities.
  17.  
  18.  
  19. ================================================================================
  20. Disclaimer and Copyright
  21. ========================
  22.  
  23.    Novell(R), Inc. makes no representations or warranties with respect to the
  24.    contents or use of this document, and specifically disclaims any express
  25.    or implied warranties of merchantability or fitness for any particular
  26.    purpose.  Further, Novell, Inc. reserves the right to revise this document
  27.    and to make changes to its content, at any time, without obligation to
  28.    notify any person or entity of such revisions or changes.
  29.  
  30.    Further, Novell, Inc. makes no representations or warranties with respect
  31.    to any NetWare software, and specifically disclaims any express or implied
  32.    warranties of merchantability or fitness for any particular purpose.
  33.    Further, Novell, Inc. reserves the right to make changes to any and all
  34.    parts of NetWare software, at any time, without any obligation to notify
  35.    any person or entity of such changes.
  36.  
  37.    PATCH.EXE is a proprietary product of PocketSoft.  PATCH.EXE and Patch Build
  38.    generated files are distributed by Novell, Inc. under license from
  39.    PocketSoft.
  40.  
  41.    Copyright (c) 1993 Novell, Inc.  All rights reserved.
  42.  
  43.  
  44. ================================================================================
  45. Contents
  46. ========
  47.  
  48.    Installation Procedure
  49.    Patch File Information
  50.    Original File Information
  51.    Patch Set Descriptions
  52.       December 1992 Patches
  53.       April 1993 Patches
  54.       December 1993 Patches
  55.    Documentation Updates
  56.       December 1992 Updates
  57.  
  58.  
  59. ================================================================================
  60. Installation Procedure
  61. ======================
  62.  
  63.    The PATCHXTR.CMD and PATCH.EXE files discussed in this procedure require
  64.    OS/2 v1.1 or later.
  65.  
  66.    The XTROS2.EXE file contains the following:
  67.  
  68.    -  This Readme document
  69.    -  PATCH.EXE (a utility Novell provides for installing product patches)
  70.    -  PATCHXTR.CMD (a batch file to facilitate patch installation)
  71.    -  Xtrieve PLUS Patch files (XTRIEVE.411 and XQLCALLS.211)
  72.    -  Replacement files (files with the same names as the files they replace)
  73.  
  74.    To update Xtrieve PLUS v4.11, complete the following steps:
  75.  
  76.    1.  Create a directory on your system, and copy the XTROS2.EXE file to
  77.        that directory.
  78.  
  79.    2.  Use the utility PKUNZIP.EXE to unzip the zipped files.
  80.  
  81.    3.  Install the Xtrieve PLUS patch files (XTRIEVE.411 and XQLCALLS.211) as
  82.        follows:
  83.  
  84.        a.  Refer to the list of patch files in the section of this Readme file
  85.        entitled "Original File Information," find the original files on your
  86.        system, and ensure that your original files match those listed.
  87.  
  88.        NOTE:  This patch is cumulative; it contains all previous patches to
  89.           Xtrieve PLUS v4.11 for OS/2.    Consequently, if you
  90.           installed a previous patch, you should restore the original
  91.           files by reinstalling them from the installation diskettes, or
  92.           by renaming the XTRIEVE.ORG file (created during the previous
  93.           patch installation) to XTRIEVE.EXE.
  94.  
  95.        b.  Use the DOS COPY command to copy the original files into the
  96.  
  97.        directory that contains the unzipped patch files from XTROS2.EXE.
  98.  
  99.        c.  Run PATCHXTR, which verifies that you are patching the original
  100.        released version of the software, applies the patch, and gives the
  101.        original files an .ORG extension.
  102.  
  103.        d.  Use the DOS COPY command to copy the patched files back to the
  104.        original file's directory.
  105.  
  106.    4.  Install the replacement files as follows:
  107.  
  108.        a.  Find the directory that contains the original files to be replaced.
  109.  
  110.        b.  Before copying the replacement files, back up the original files
  111.        to a diskette or to another directory.
  112.  
  113.        c.  Use the COPY command to replace the original files with the
  114.        new files.
  115.  
  116.    5.  After applying the patches, you can remove the directory you created to
  117.        store the XTROS2.EXE file.  You may also want to verify the version
  118.        numbers when you load each program.  The version numbers should match
  119.        those listed in the next section, "Patch File Information."
  120.  
  121.  
  122. ================================================================================
  123. Patch File Information
  124. ======================
  125.  
  126.    Patch Set Filename:    XTROS2.EXE
  127.  
  128.    Date:        12-13-93
  129.  
  130.    Files Included:    XTROS2     DOC           This document
  131.             XTROS2   TXT           Short Readme
  132.             PATCH     EXE           76981   1-30-92      5:00a
  133.             PATCHXTR CMD        3928  12-17-92      3:55p
  134.  
  135.    Patch File:        XTROS2     411  v4.11e   81578  12-08-93    12:08p
  136.             XQLCALLS 211         538  12-17-92     3:27p
  137.  
  138.    Replacement Files:    MAKE_XTA EXE  v4.11c   74882  11-19-93     2:57p
  139.             XCFP     EXE  v4.11c   40946  11-19-93     2:53p
  140.             XHFP     EXE  v4.11b   26192  12-09-92    11:17a
  141.             XMENU     EXE  v4.11b  133592  12-09-92    11:14a
  142.             XTRIEVE  MSG           39077  11-18-93     1:38p
  143.             XTRIEVE  MEN  v4.11c   13347  11-18-93     1:38p
  144.  
  145.  
  146. ================================================================================
  147. Original File Information
  148. =========================
  149.  
  150.    To ensure you are patching the original files, compare the files to be
  151.    patched with those in the following list.  This list shows the byte size
  152.    and the date and time stamps for the original release.
  153.  
  154.    Patch these files:
  155.             XTRIEVE  EXE   v4.11  464362    8-13-92   11:21a
  156.             XQLCALLS ORG   v2.11  399291   10-18-90   12:28p
  157.  
  158.    Replace these files:
  159.             MAKE_XTA EXE   v4.11   71738    6-25-92    7:45p
  160.             XCFP     EXE   v4.11   56994    6-25-92    8:07p
  161.             XHFP     EXE   v4.11   26192    6-25-92    8:06p
  162.             XMENU     EXE   v4.11  133592    9-16-92   12:57p
  163.             XTRIEVE  MSG           39017    8-11-92    3:59p
  164.             XTRIEVE  MEN   v4.11   13347    8-11-92    3:59p
  165.  
  166.    NOTE:  You may have newer versions of the replacement files listed above
  167.       that you received in a previous patch release.  Replace those
  168.       existing files with the files included in this current patch release.
  169.  
  170.  
  171. ================================================================================
  172. Patch Set Descriptions
  173. ======================
  174.  
  175.    This section describes each patch in the patch set.    The patch descriptions
  176.    are grouped by release date.  Within each release group, the patch
  177.    descriptions for the Xtrieve PLUS engine appear first, followed by those for
  178.    the utilities.
  179.  
  180.    For each patch, the description includes one or more search strings.  These
  181.    search strings indicate areas in which you may encounter the problem that the
  182.    patch addresses.  The search strings may help you quickly determine whether
  183.    the patch you need for a specific problem is included in this patch set.
  184.  
  185.    NOTE:  In some cases, the text describes a problem or reported bug that the
  186.       update does NOT fix.    In those cases, use the workaround provided.
  187.  
  188.    * * * * * * * * *
  189.  
  190.  
  191. December 1992 Patches
  192. ---------------------
  193.  
  194.    The following information describes patches released in December 1992.
  195.  
  196.    * * * * * * * * *
  197.  
  198.    Product/Platform:  OS/2 - XTRIEVE.EXE, v4.11
  199.  
  200.    Search String:  DISPLAY ERRORS
  201.  
  202.    Problem:
  203.  
  204.    In the Report Layout screen, when you insert a field between two fields that
  205.    take up a relatively large portion of the screen, Xtrieve PLUS redraws the
  206.    screen incorrectly.    This patch does not contain a fix; Xtrieve PLUS
  207.    accurately stores the new data.
  208.  
  209.    * * * * * * * * *
  210.  
  211.    Product/Platform:  OS/2 - XTRIEVE.EXE, v4.11
  212.  
  213.    Search Strings:  F8, HANG, MODIFYING, REPORT LAYOUT
  214.  
  215.    Problem Fixed by This Patch:
  216.  
  217.    When you repeatedly use the key sequence Shift+F8, F8, and Esc when modifying
  218.    or viewing groups or fields in a report layout, Xtrieve PLUS terminates.
  219.  
  220.    This patch ensures that Xtrieve PLUS properly closes and reopens the report
  221.    layout windows, thus preventing Xtrieve PLUS from terminating.
  222.  
  223.    * * * * * * * * *
  224.  
  225.    Product/Platform:  OS/2 - XTRIEVE.EXE, v4.11
  226.  
  227.    Search Strings:  GROUP FIELD, GROUP SUMMARY, REPORT FIELD, REPORT SUMMARY
  228.  
  229.    Problem Fixed by This Patch:
  230.  
  231.    If you use a report field in a report field summary or a group field in a
  232.    group field summary, Xtrieve PLUS does not allow you to remove or modify the
  233.    field.  This patch ensures that Xtrieve PLUS allows you to remove or modify
  234.    such fields.
  235.  
  236.    * * * * * * * * *
  237.  
  238.    Product/Platform:  OS/2 - XTRIEVE.EXE, v4.11
  239.  
  240.    Search Strings:  FORM/ADD EDIT SCREEN, INVALID RECORD
  241.  
  242.    Problem Fixed by This Patch:
  243.  
  244.    If you attempt to add an invalid record using the Form/Add edit screen,
  245.    Xtrieve PLUS exits the Form/Add edit screen and returns to the Form menu.
  246.    This patch ensures that if an error occurs when you attempt to add a record,
  247.    Xtrieve PLUS remains at the edit screen.
  248.  
  249.    * * * * * * * * *
  250.  
  251.    Product/Platform:  OS/2 - XTRIEVE.EXE, v4.11
  252.  
  253.    Search String:  REPORT LAYOUT
  254.  
  255.    Problem Fixed by This Patch:
  256.  
  257.    When XQL and Btrieve are loaded by Xtrieve PLUS, a report layout may become
  258.    corrupt in memory after you print the report.  This patch ensures that
  259.    Xtrieve PLUS correctly maintains report layouts.
  260.  
  261.    * * * * * * * * *
  262.  
  263.    Product/Platform:  OS/2 - XTRIEVE.EXE, v4.11
  264.  
  265.    Search String:  REMOVE GROUP
  266.  
  267.    Problem Fixed by This Patch:
  268.  
  269.    If you remove a group from a report and then attempt to remove another
  270.    group, Xtrieve PLUS displays a repetitive list of groups from which to
  271.    choose.  In addition, if you choose one of the listed groups, Xtrieve PLUS
  272.    causes the workstation to freeze.  This patch ensures that Xtrieve PLUS
  273.    correctly displays lists of groups.
  274.  
  275.    * * * * * * * * *
  276.  
  277.    Product/Platform:  OS/2 - XTRIEVE.EXE, v4.11
  278.  
  279.    Search Strings:  BLANKS, IMPORT DATA, SDF
  280.  
  281.    Problem Fixed by This Patch:
  282.  
  283.    Xtrieve PLUS incorrectly imports data in Standard Data Format (SDF) if
  284.    blanks separate the data elements, as in the following example:
  285.  
  286.    "Firstname", "Middlename", "Lastname"
  287.  
  288.    This patch ensures that Xtrieve PLUS correctly imports SDF data.
  289.  
  290.    * * * * * * * * *
  291.  
  292.    Product/Platform:  OS/2 - XTRIEVE.EXE, v4.11
  293.  
  294.    Search Strings:  LVAR, NOTE, TRANSLATE, VARIABLE-LENGTH FIELDS
  295.  
  296.    Problem Fixed by This Patch:
  297.  
  298.    Xtrieve PLUS does not accurately perform view-to-view translations on
  299.    variable-length fields that are not of the same type.  For example, you
  300.    cannot accurately translate a note field into an lvar field.  This patch
  301.    ensures that Xtrieve PLUS correctly performs such translations.
  302.  
  303.    * * * * * * * * *
  304.  
  305.    Product/Platform:  OS/2 - XTRIEVE.EXE, v4.11
  306.  
  307.    Search Strings:  CREATE FILE, PAGE, PREALLOCATION
  308.  
  309.    Problem Fixed by This Patch:
  310.  
  311.    When you are creating files, Xtrieve PLUS allows you to preallocate no more
  312.    than 32,767 pages.  This patch ensures that Xtrieve PLUS allows you to
  313.    preallocate up to 65,535 pages.
  314.  
  315.    * * * * * * * *
  316.  
  317.    Product/Platform:  OS/2 - XTRIEVE.EXE, v4.11
  318.  
  319.    Search Strings:  BTRIEVE, NEW COMMAND LINE OPTIONS, UNLOAD, XQL
  320.  
  321.    Problem Fixed by This Patch:
  322.  
  323.    Xtrieve PLUS does not unload Btrieve or XQL from memory if you loaded Btrieve
  324.    or XQL before you entered Xtrieve PLUS.  If you do not have the utilities
  325.    BUTIL or NSUTIL, you cannot unload XQL or Btrieve from memory.  This patch
  326.    makes available two new command line options you can specify when you load
  327.    Xtrieve PLUS:
  328.  
  329.    /ua       Unloads both XQL and Btrieve when you exit Xtrieve PLUS
  330.  
  331.    /ux       Unloads only XQL when you exit Xtrieve PLUS
  332.  
  333.    * * * * * * * * *
  334.  
  335.    Product/Platform:  OS/2 - XTRIEVE.EXE, v4.11
  336.  
  337.    Search Strings:  CONDITIONAL, FIELD LIST, SCALAR FUNCTIONS,
  338.             USER-DEFINED FIELDS
  339.  
  340.    Problem:
  341.  
  342.    Xtrieve PLUS may not display all available fields in a field list when you
  343.    are defining a user-defined field that includes nested conditions or nested
  344.    scalar functions, as in the following example expression:
  345.  
  346.    Result = SUBSTRING( SUBSTRING( SUBSTRING( Field3,5,20),2,Field2),5,Field1)
  347.  
  348.    Workaround:
  349.  
  350.    For each level of nesting, create a temporary, user-defined field, as in the
  351.    following example:
  352.  
  353.    TempField1 = SUBSTRING( Field3,5,20)
  354.  
  355.    TempField2 = SUBSTRING( TempField1,2,Field2)
  356.  
  357.    TempField3 = SUBSTRING( TempField2,5,Field1)
  358.  
  359.    Since Xtrieve PLUS embeds the temporary field definitions in the substring
  360.    field that references it, you can delete the interim temporary fields,
  361.    resulting in a single, user-defined field, as in the following example:
  362.  
  363.    Result = TempField3
  364.  
  365.    * * * * * * * * *
  366.  
  367.    Product/Platform:  OS/2 - XTRIEVE.EXE, v4.11
  368.  
  369.    Search Strings:  DECIMAL POINTS, INTEGER FIELDS, MASKS
  370.  
  371.    Problem:
  372.  
  373.    If you place a mask that contains decimal points (such as ZZZ,ZZ9.99) on an
  374.    integer field, you may get unexpected results in report summary fields.  For
  375.    example, if the field's data is 38,470.00, the masked result is 384.70.
  376.  
  377.    Workaround:
  378.  
  379.    Masks on integer fields should not contain decimal points.  Use a more
  380.    appropriate data type, such as decimal, float, money, or numeric.
  381.  
  382.    * * * * * * * * *
  383.  
  384.    Product/Platform:  OS/2 - XTRIEVE.PDB
  385.  
  386.    Search Strings:  PRINTER, TABLOID SETTING
  387.  
  388.    Problem:
  389.  
  390.    The Tabloid setting of the XTRIEVE.PDB file specifies the Epson LQ-1500/2.0
  391.    printer instead of the IBM PC graphics printer.
  392.  
  393.    Workaround:
  394.  
  395.    Change the Tabloid setting as follows.
  396.  
  397.    1.  At a DOS workstation, enter SLATE XTRIEVE.PDB.
  398.  
  399.    2.  In the SLATE utility, follow these steps to set the Tabloid setting:
  400.  
  401.        a.  Select the Add/Edit Devices (Ptr Connections) option from the main
  402.        menu.
  403.  
  404.        b.  Select the 3001 Tabloid option from the Devices menu.
  405.  
  406.        c.  Use the Tab key to move to the Ptr Mfg field and press F9 to display
  407.        a list of printer manufacturers.
  408.  
  409.        d.  Select IBM.
  410.  
  411.        e.  Use the Tab key to move to the Ptr Type field and press F9 to display
  412.        a list of printer types.
  413.  
  414.        f.  Select PC Graphics Printer.
  415.  
  416.    3.  To exit SLATE, press F10 three times.
  417.  
  418.    * * * * * * * * *
  419.  
  420.    Product/Platform:  OS/2 - MAKE_XTA.EXE, v4.11
  421.  
  422.    Search Strings:  3, HANG, OPEN VIEWS
  423.  
  424.    Problem Fixed by This Patch:
  425.  
  426.    The MAKE_XTA utility hangs or returns Status Code 3 (File Not Open) when you
  427.    attempt to open certain views.  This patch ensures that MAKE_XTA can open
  428.    such views.
  429.  
  430.    * * * * * * * * *
  431.  
  432.    Product/Platform:  OS/2 - MAKE_XTA.EXE, v4.11
  433.  
  434.    Search Strings:  FIELD NAMES, LOWERCASE, UPPERCASE
  435.  
  436.    Problem Fixed by This Patch:
  437.  
  438.    The MAKE_XTA utility converts all letters in user-defined field names to
  439.    uppercase.  This patch ensures that MAKE_XTA preserves lowercase letters in
  440.    field names.
  441.  
  442.    * * * * * * * * *
  443.  
  444.    Product/Platform:  OS/2 - MAKE_XTA.EXE, v4.11
  445.  
  446.    Search Strings:  EQJOIN, EQUAL, JOIN, KEYWORD, NULL, NULLJOIN
  447.  
  448.    Problem Fixed by This Patch:
  449.  
  450.    The MAKE_XTA utility inserts incorrect keywords in .XTA files that contain
  451.    file joins.    For example, MAKE_XTA uses the keyword EQUAL when it should use
  452.    the keyword EQJOIN.    This patch ensures that MAKE_XTA inserts the correct
  453.    keywords.
  454.  
  455.    * * * * * * * * *
  456.  
  457.    Product/Platform:  OS/2 - MAKE_XTA.EXE, v4.11
  458.  
  459.    Search Strings:  ADD KEYWORD, REPORT LAYOUT, SUM
  460.  
  461.    Problem Fixed by This Patch:
  462.  
  463.    If a report layout contains the calculation type SUM, the MAKE_XTA
  464.    utility inserts an extra .ADD. keyword in the XTA file.  This patch ensures
  465.    that MAKE_XTA inserts the correct number of .ADD. keywords.
  466.  
  467.    * * * * * * * * *
  468.  
  469.    Product/Platform:  OS/2 - MAKE_XTA.EXE, v4.11
  470.  
  471.    Search Strings:  ADJACENT FIELDS, BIT FIELDS
  472.  
  473.    Problem Fixed by This Patch:
  474.  
  475.    If a dictionary contains two or more adjacent fields of type bit, the
  476.    MAKE_XTA utility inserts only the first bit field in the .XTA file.    This
  477.    patch ensures that MAKE_XTA inserts all bit fields.
  478.  
  479.    * * * * * * * * *
  480.  
  481.    Product/Platform:  OS/2 - MAKE_XTA.EXE, v4.11
  482.  
  483.    Search Strings:  AUTOINC, INDEX ATTRIBUTES
  484.  
  485.    Problem Fixed by This Patch:
  486.  
  487.    The MAKE_XTA utility incorrectly extracts the index attributes of fields of
  488.    type autoinc.  This patch ensures that MAKE_XTA retains index attributes as
  489.    defined in the original file.
  490.  
  491.    * * * * * * * * *
  492.  
  493.    Product/Platform:  OS/2 - MAKE_XTA.EXE, v4.11
  494.  
  495.    Search Strings:  EXTRACT FILES, SUPPLEMENTAL INDEX
  496.  
  497.    Problem Fixed by This Patch:
  498.  
  499.    The MAKE_XTA utility fails when attempting to extract files that contain
  500.    supplemental indexes.  This patch ensures that MAKE_XTA correctly extracts
  501.    supplemental indexes.
  502.  
  503.    * * * * * * * * *
  504.  
  505.    Product/Platform:  OS/2 - MAKE_XTA.EXE, v4.11
  506.  
  507.    Search String:  DESCRIPTIVE FILENAME
  508.  
  509.    Problem Fixed by This Patch:
  510.  
  511.    If a descriptive filename is shorter than the actual filename, the MAKE_XTA
  512.    utility pads the rest of the descriptive filename with characters from the
  513.    actual filename.  For example, given a descriptive filename of FILE and an
  514.    actual filename of TESTING, MAKE_XTA converts the descriptive filename to
  515.    FILEING.  This patch ensures that MAKE_XTA inserts the correct descriptive
  516.    filename into the generated .XTA file.
  517.  
  518.    * * * * * * * * *
  519.  
  520.    Product/Platform:  OS/2 - MAKE_XTA.EXE, v4.11
  521.  
  522.    Search Strings:  EXTRACT VIEWS, USER-DEFINED FIELDS
  523.  
  524.    Problem Fixed by This Patch:
  525.  
  526.    The MAKE_XTA utility incorrectly extracts files containing relatively large
  527.    user-defined fields.  This patch ensures that MAKE_XTA correctly extracts
  528.    such files.
  529.  
  530.    * * * * * * * * *
  531.  
  532.    Product/Platform:  OS/2 - MAKE_XTA.EXE, v4.11
  533.  
  534.    Search Strings:  CONDITIONAL USER-DEFINED FIELDS, MASKS
  535.  
  536.    Problem:
  537.  
  538.    If you define a conditional user-defined field in Xtrieve PLUS and you define
  539.    a mask for the field, MAKE_XTA does not maintain the mask when it creates the
  540.    .XTA file.
  541.  
  542.    Workaround:
  543.  
  544.    Edit the .XTA file to restore the mask definitions for each conditional
  545.    user-defined field you want masked.
  546.  
  547.    * * * * * * * * *
  548.  
  549.    Product/Platform:  OS/2 - XCFP.EXE, v4.11
  550.  
  551.    Search Strings:  COMMANDS WITH NUMERALS, PAGE SIZE
  552.  
  553.    Problem Fixed by This Patch:
  554.  
  555.    The Xtrieve PLUS Command File Processor (XCFP) utility does not recognize the
  556.    command that specifies page size since the command begins with a numeral.
  557.    This patch ensures that XCFP recognizes commands that begin with numerals.
  558.  
  559.    * * * * * * * * *
  560.  
  561.  
  562. April 1993 Patches
  563. ------------------
  564.  
  565.    The following information describes patches released in April 1993.
  566.  
  567.  
  568.    * * * * * * * * *
  569.  
  570.    Product/Platform:  OS/2 - XTRIEVE.EXE, v4.11
  571.  
  572.    Search Strings:  MAXIMUM NUMBER OF VIEWS (819), MEMORY ERROR,
  573.             /V STARTUP OPTION
  574.  
  575.    Problem Fixed by This Patch:
  576.  
  577.    Xtrieve PLUS returns a memory error on View Release and/or Retain operations
  578.    when you specify more than 819 views.  This patch ensures that when you
  579.    specify more than 819 views for the /V startup option (for example, /V:850),
  580.    you receive the following message:
  581.  
  582.    Xtrieve: Invalid view parameter
  583.  
  584.    * * * * * * * * *
  585.  
  586.    Product/Platform:  OS/2 - XTRIEVE.EXE, v4.11
  587.  
  588.    Search Strings:  INVALID COMMAND-LINE PARAMETER, TEMPORARY FILES,
  589.             XTRTMP_M.* FILE
  590.  
  591.    Problem Fixed by This Patch:
  592.  
  593.    When you supply Xtrieve PLUS with an invalid command-line parameter, the
  594.    program removes all temporary files except the XTRTMP_M.* file.  This patch
  595.    ensures that Xtrieve PLUS correctly deletes all temporary files.
  596.  
  597.    * * * * * * * * *
  598.  
  599.    Product/Platform:  OS/2 - XTRIEVE.EXE, v4.11
  600.  
  601.    Search Strings:  BFLOAT DATA TYPE, RESTRICTION
  602.  
  603.    Problem Fixed by This Patch:
  604.  
  605.    Since Xtrieve PLUS v4.11b does not insert a bfloat data type correctly, any
  606.    restriction based on a bfloat data type returns invalid results.  This patch
  607.    ensures that Xtrieve PLUS recognizes the version of the program that you are
  608.    using and correctly adapts the input value to work in that environment.
  609.  
  610.    * * * * * * * * *
  611.  
  612.    Product/Platform:  OS/2 - XTRIEVE.EXE, v4.11
  613.  
  614.    Search Strings:  EXITING XTRIEVE, SUSPENDED COMMAND FILE
  615.  
  616.    Problem Fixed by This Patch:
  617.  
  618.    When you use a CTRL+Break key sequence while an Xtrieve PLUS command file is
  619.    suspended, Xtrieve PLUS causes you to exit from the program.  This patch
  620.    ensures that Xtrieve PLUS stops the command file execution rather than
  621.    exiting from the program.
  622.  
  623.    * * * * * * * * *
  624.  
  625.    Product/Platform:  OS/2 - XTRIEVE.EXE, v4.11
  626.  
  627.    Search Strings:  2101, /D OPTION, DATA DICTIONARY, DICTIONARY SHOW, NSREQ
  628.  
  629.    Problem Fixed by This Patch:
  630.  
  631.    When you use the NetWare SQL Requester (NSREQ.EXE or NSREQS.EXE) to access
  632.    dictionaries through Xtrieve PLUS and the Dictionary Show command does
  633.    not display any dictionaries, restart the Requester and specify a larger
  634.    length for the data message with the /D option (Date Message Length).  The
  635.    Show Dictionary command then displays a list of all available dictionaries.
  636.  
  637.    This patch ensures that the NetWare SQL Requester displays Status Code 2101
  638.    (Data Message Buffer Is Too Small) when a request to read Xtrieve data, such
  639.    as a list of dictionaries, fails.
  640.  
  641.    * * * * * * * * *
  642.  
  643.    Product/Platform:  OS/2 - XTRIEVE.EXE, v4.11
  644.  
  645.    Search Strings:  248, BLANKS, CHARACTER FIELD/LIST, INSERT
  646.  
  647.    Problem Fixed by This Patch:
  648.  
  649.    When you press Enter on a character field in an insert screen for which you
  650.    have defined a character list and no data is shown, Xtrieve PLUS returns
  651.    Status Code 248 (Invalid Size for Data Type) even if blanks are permitted in
  652.    that field.    This patch ensures that Xtrieve PLUS handles such character
  653.    fields correctly.
  654.  
  655.    * * * * * * * * *
  656.  
  657.    Product/Platform:  NetWare SQL - XTRIEVE.EXE, v4.11
  658.  
  659.    Search Strings:  GROUP/SUMMARY, REPORT LAYOUT, TRAP ERROR
  660.  
  661.    Problem Fixed by This Patch:
  662.  
  663.    When you choose Group/Summary in the Report Layout, Xtrieve PLUS receives a
  664.    trap error (the result of incorrectly initializing the Group/Summary
  665.    element), which may occur in all three environments (NetWare SQL, DOS, and
  666.    OS/2).  This patch ensures that Xtrieve PLUS handles the Group/Summary
  667.    element correctly.
  668.  
  669.    * * * * * * * * *
  670.  
  671.    Product/Platform:  OS/2 - MAKE_XTA.EXE, v4.11
  672.  
  673.    Search Strings:  BRACKETED CONDITIONAL FIELD, CONSTANT, USER-DEFINED FIELD
  674.  
  675.    Problem Fixed by This Patch:
  676.  
  677.    The MAKE_XTA utility does not properly convert constants when extracting a
  678.    view containing a user-defined field that includes a bracketed conditional
  679.    field.  This patch ensures that MAKE_XTA handles such user-defined fields
  680.    correctly.
  681.  
  682.    * * * * * * * * *
  683.  
  684.    Product/Platform:  OS/2 - MAKE_XTA.EXE, v4.11
  685.  
  686.    Search Strings:  COMMAND FILE, DEFINED VIEW, JUSTIFICATION, XCFP
  687.  
  688.    Problem Fixed by This Patch:
  689.  
  690.    When you use the MAKE_XTA utility to extract a defined view and then use the
  691.    Xtrieve Command File Processor (XCFP) to make that view into a command file,
  692.    Xtrieve drops the left/right/center justification.  This patch ensure that
  693.    the MAKE_XTA utility places the correct justification information in the
  694.    .XTA file.
  695.  
  696.    * * * * * * * * *
  697.  
  698.    Product/Platform:  OS/2 - MAKE_XTA.EXE, v4.11
  699.  
  700.    Search Strings:  FIELD, FLOATING POINT VALUES, MASKABLE DATA TYPE,
  701.             UNFORMATTING DATA
  702.  
  703.    Problem Fixed by This Patch:
  704.  
  705.    The MAKE_XTA utility is not handling maskable data type fields correctly,
  706.    causing an invalid mask when unformatting data.  In addition, the utility
  707.    is not translating floating point values correctly.    This patch ensures that
  708.    the MAKE_XTA utility handles both maskable data type fields and floating
  709.    point values correctly.
  710.  
  711.    * * * * * * * * *
  712.  
  713.    Product/Platform:  OS/2 - XTRIEVE.EXE, v4.11
  714.  
  715.    Search Strings:  HEWLETT PACKARD LASERJET PRINTER, VARIABLE-WIDTH FONTS
  716.  
  717.    Additional Printer Information:
  718.  
  719.    Variable-width fonts for the Hewlett Packard series of Laserjet printers do
  720.    not work correctly with Xtrieve PLUS.
  721.  
  722.    * * * * * * * * *
  723.  
  724.  
  725. December 1993 Patches
  726. ---------------------
  727.  
  728.    The following information describes patches released in December 1993.
  729.  
  730.  
  731.    * * * * * * * * *
  732.  
  733.    Product/Platform:  OS/2 - XTRIEVE.EXE, v4.11
  734.  
  735.    Search Strings:  GROUP, HANG, REMOVE, SUMMARIES
  736.  
  737.    Problem Fixed by This Patch:
  738.  
  739.    Xtrieve does not successfully remove a report group that contains a group
  740.    summary.  This occurs when you use GROUP/REMOVE from the Report menu to
  741.    remove from a table a group containing other groups that themselves contain
  742.    group summaries.  When you again choose GROUP/REMOVE, Xtrieve displays the
  743.    remaining group names multiple times in the list of groups.    If you then try
  744.    to remove any of the remaining groups, the computer hangs.  This patch
  745.    ensures that Xtrieve handles this type of operation correctly.
  746.  
  747.    * * * * * * * * *
  748.  
  749.    Product/Platform:  OS/2 - XTRIEVE.EXE, v4.11
  750.  
  751.    Search Strings:  HANG, PRINT, REPORT
  752.  
  753.    Problem Fixed by This Patch:
  754.  
  755.    When you attempt to print a report that contains groups, the printer
  756.    occasionally hangs after printing the first page.  This problem occurs,
  757.    however, only when you position the groups so that subsequent groups print
  758.    on the same line as the first group.  In that case, Xtrieve tracks the
  759.    current line and column positions inaccurately, attempts to place too much
  760.    information on a page, overwrites memory, and causes the workstation to
  761.    hang.  This patch ensures that Xtrieve properly tracks current line and
  762.    column positions.
  763.  
  764.    NOTE:  If a group contains any fields, do not define group control fields
  765.       with a line position of +0.  In most cases, this operation does not
  766.       produce the intended printed results.  Instead, define the group with
  767.       a line position of +1, which places each occurence of the fields in
  768.       the group on a new line.
  769.  
  770.    * * * * * * * * *
  771.  
  772.    Product/Platform:  OS/2 - XTRIEVE.EXE, v4.11
  773.  
  774.    Search Strings:  EMPTY FIELD, NOTE, SDF, TRANSLATE
  775.  
  776.    Problem Fixed by This Patch:
  777.  
  778.    When translating a view including a NOTE or LVAR field that contains no data
  779.    into SDF format, Xtrieve produces a field value of (HEX) 0xF9 in double
  780.    quotation marks.  This patch ensures that Xtrieve translates the value as ""
  781.    with no data included between the quotes.
  782.  
  783.    * * * * * * * * *
  784.  
  785.    Product/Platform:  OS/2 - XTRIEVE.EXE, v4.11
  786.  
  787.    Search Strings:  221, USER-DEFINED FIELD
  788.  
  789.    Problem Fixed by This Patch:
  790.  
  791.    Xtrieve returns a Status Code 221 (Invalid Syntax for Expression or
  792.    Restriction) when building an expression for a user-defined field.  This
  793.    patch ensures that Xtrieve always zero-terminates a user-defined field
  794.    expression before sending that expression to NetWare SQL for processing.
  795.  
  796.    * * * * * * * * *
  797.  
  798.    Product/Platform:  OS/2 - XTRIEVE.EXE, v4.11
  799.  
  800.    Search Strings:  LOADING WITH /? OR /H, XTRTMP_*.*, ZERO BYTES
  801.  
  802.    Problem Fixed by This Patch:
  803.  
  804.    When you load Xtrieve with the /?, or /h parameters, it leaves XTRTMP_M.*
  805.    and XTRTMP_L.* files with zero bytes in the XTRTMP directory.  This patch
  806.    ensures that Xtrieve always removes XTRTMP_*.* files when it terminates.
  807.  
  808.    * * * * * * * * *
  809.  
  810.    Product/Platform:  OS/2 - XTRIEVE.EXE, v4.11
  811.  
  812.    Search Strings:  F1, HEAP SPACE, HELP
  813.  
  814.    Problem Fixed by This Patch:
  815.  
  816.    Xtrieve occasionally returns the message "Out of local heap space" when you
  817.    press F1 for help.  This patch ensures that Xtrieve always reserves enough
  818.    space in memory for the help text.
  819.  
  820.    * * * * * * * * *
  821.  
  822.    Product/Platform:  OS/2 - XTRIEVE.EXE, v4.11
  823.  
  824.    Search Strings:  EXTRA 0, FLOAT, MASK
  825.  
  826.    Problem Fixed by This Patch:
  827.  
  828.    Xtrieve adds an extra zero following the decimal point to float values when
  829.    the display mask for those values contains the special () literals.    This
  830.    patch ensures that these special literals do not affect the number of
  831.    digits following the decimal point.
  832.  
  833.    * * * * * * * * *
  834.  
  835.    Product/Platform:  OS/2 - XTRIEVE.EXE, v4.11
  836.  
  837.    Search Strings:  EXTRA BLANK PAGE, PRINT DEFINITION
  838.  
  839.    Problem Fixed by This Patch:
  840.  
  841.    When you print a definition (view, report, or dictionary table), Xtrieve
  842.    prints an extra blank page before printing the actual definition.  This
  843.    patch ensures that the first printed page is the first page of the
  844.    definition.
  845.  
  846.    * * * * * * * * *
  847.  
  848.    Product/Platform:  OS/2 - XTRIEVE.EXE, v4.11
  849.  
  850.    Search Strings:  CONDITIONAL, USER-DEFINED FIELD
  851.  
  852.    Problem Fixed by This Patch:
  853.  
  854.    Xtrieve does not properly define a user-defined field if its definition is
  855.    based on a conditional statement and other user-defined fields.  The problem
  856.    occurs when you include in the definition a condition that compares two
  857.    user-defined fields.  This patch ensures that Xtrieve includes the correct
  858.    fields in a conditional user-defined field and correctly defines the entire
  859.    field.
  860.  
  861.    * * * * * * * * *
  862.  
  863.    Product/Platform:  OS/2 - XTRIEVE.EXE, v4.11
  864.  
  865.    Search Strings:  DEFINITION, PRINT, VIEW
  866.  
  867.    Problem Fixed by This Patch:
  868.  
  869.    When printing a large view definition, such as one with many joined files,
  870.    Xtrieve displays the following error message:  "Error writing output."  This
  871.    patch ensures that Xtrieve allocates a buffer large enough to handle
  872.    multiple joined file views so that you can print the definition of such a
  873.    view.
  874.  
  875.    * * * * * * * * *
  876.  
  877.    Product/Platform:  OS/2 - XTRIEVE.EXE, v4.11
  878.  
  879.    Search Strings:  DICTIONARY, INDEX, PRINT, SHOW
  880.  
  881.    Problem Fixed by This Patch:
  882.  
  883.    If you drop an index from a table definition and do not renumber the
  884.    remaining indexes, Xtrieve does not display the definitions for indexes with
  885.    a number higher than the one that was dropped.  This patch ensures that
  886.    Xtrieve correctly finds all index definitions when showing or printing a
  887.    table definition.
  888.  
  889.    * * * * * * * * *
  890.  
  891.    Product/Platform:  OS/2 - XTRIEVE.EXE, v4.11
  892.  
  893.    Search Strings:  COMPLETE, RESTRICT, VARIABLE FIELD
  894.  
  895.    Problem Fixed by This Patch:
  896.  
  897.    In some cases, you cannot complete a restriction when that restriction
  898.    includes a variable length field because Xtrieve occasionally overwrites
  899.    memory in this situation.  This patch ensures that no memory overwrite
  900.    occurs, enabling you to complete the restriction.
  901.  
  902.    * * * * * * * * *
  903.  
  904.    Product/Platform:  OS/2 - XTRIEVE.EXE, v4.11
  905.  
  906.    Search Strings:  213, OWNER NAME, VIEW
  907.  
  908.    Problem Fixed by This Patch:
  909.  
  910.    Xtrieve displays Status Code 213 (Read Access) when the XTROWNER variable
  911.    does not contain the owner name(s) required to recall a view definition.
  912.    This patch ensures that Xtrieve requests the owner names when recalling a
  913.    view just as it does when opening a table for a view.  The only difference
  914.    is that Xtrieve asks for an owner name each time after you press Enter until
  915.    you press ESC, or until you press Enter if you have not typed a name at the
  916.    prompt.
  917.  
  918.    * * * * * * * * *
  919.  
  920.    Product/Platform:  OS/2 - XTRIEVE.EXE, v4.11
  921.  
  922.    Search Strings:  /D PARAMETER, /K PARAMETER, COMMAND FILE, KEYBOARD FILE,
  923.             LOADING XTRIEVE
  924.  
  925.    Problem Fixed by This Patch:
  926.  
  927.    Xtrieve does not load successfully when you specify a keyboard input file
  928.    along with the /D parameter.  This patch ensures that you can load Xtrieve
  929.    when you specify the /D parameter and a keyboard input file, provided that
  930.    you also specify either the /K parameter or a command file.
  931.  
  932.    * * * * * * * * *
  933.  
  934.    Product/Platform:  OS/2 - XTRIEVE.EXE, v4.11
  935.  
  936.    Search Strings:  DATE FIELD, DIF FILE, LOTUS 123
  937.  
  938.    Problem Fixed by This Patch:
  939.  
  940.    When Xtrieve translates a date field into a DIF file format and you then
  941.    load the DIF file into Lotus 123, the date value appears as ******.    (This
  942.    problem occurs only when Xtrieve is loaded and you are using XQLP 2.x.) This
  943.    patch ensures that Xtrieve correctly translates the date values to the DIF
  944.    file format.
  945.  
  946.    * * * * * * * * *
  947.  
  948.    Product/Platform:  OS/2 - XTRIEVE.EXE, v4.11
  949.  
  950.    Search Strings:  227, USER-DEFINED FIELD
  951.  
  952.    Problem Fixed by This Patch:
  953.  
  954.    When the menu for a user-defined field definition is full and cannot hold
  955.    any additional entries, Xtrieve displays Status Code 227 (Operand Must Be a
  956.    Dictionary Field) when completing the definition.  This patch ensures that
  957.    Xtrieve correctly tracks the table name for a field when the menu
  958.    is full and then builds the definition correctly.
  959.  
  960.    * * * * * * * * *
  961.  
  962.    Product/Platform:  OS/2 - MAKE_XTA.EXE, v4.11
  963.  
  964.    Search Strings:  COMMAND FILE NOT REPLAYABLE, REPORT LAYOUT DEFINITION, XCFP
  965.  
  966.    Problem Fixed by This Patch:
  967.  
  968.    When MAKE_XTA extracts a report layout definition and XCFP converts that
  969.    .XTA file to an .XTC file, Xtrieve returns the error message "Command file
  970.    contains keystroke which is not replayable," and the command file does not
  971.    complete.  This patch modifies the way in which MAKE_XTA builds .XTA files
  972.    for report layouts so that the command file contains valid keystrokes and
  973.    builds the correct report.
  974.  
  975.    * * * * * * * * *
  976.  
  977.    Product/Platform:  OS/2 - MAKE_XTA.EXE, v4.11
  978.  
  979.    Search Strings:  APPEND, BRACKET COMMAND, CONCATENATE, USER-DEFINED STRING
  980.             FIELD
  981.  
  982.    Problem Fixed by This Patch:
  983.  
  984.    When converting a user-defined field into an .XTA file, MAKE_XTA adds a
  985.    .BRACKET. command when it attempts to append one string to another string or
  986.    to concatenate two strings.    This patch ensures that MAKE_XTA does not
  987.    insert a .BRACKET. command when converting a user-defined string field.
  988.  
  989.    * * * * * * * * *
  990.  
  991.    Product/Platform:  OS/2 - MAKE_XTA.EXE, v4.11
  992.  
  993.    Search Strings:  FIELD HEADINGS AND OFFSETS, VIEWS
  994.  
  995.    Problem Fixed by This Patch:
  996.  
  997.    When MAKE_XTA converts a view, it occasionally uses the field names, rather
  998.    than the user-specified headings, for the fields in the view.  Also,
  999.    MAKE_XTA does not insert the correct field offset.  This patch ensures that
  1000.    MNAKE_XTA employs the user-specified field heading for all fields and
  1001.    inserts the correct field offset.
  1002.  
  1003.    * * * * * * * * *
  1004.  
  1005.    Product/Platform:  OS/2 - MAKE_XTA.EXE, v4.11
  1006.  
  1007.    Search Strings:  MULTIPLE FIELD NAMES, TABLE NAMES, VIEWS
  1008.  
  1009.    Problem Fixed by This Patch:
  1010.  
  1011.    When MAKE_XTA converts a view, it does not select the correct occurrence of
  1012.    a field when the field name appears more than once in the view.  (This
  1013.    occurs because MAKE_XTA does not accurately determining the correct table
  1014.    name for the field.)  This patch ensures that when you are rebuilding a view
  1015.    definition, MAKE_XTA determines the correct table name whenever you select a
  1016.    field name from a menu.
  1017.  
  1018.    * * * * * * * * *
  1019.  
  1020.    Product/Platform:  OS/2 - MAKE_XTA.EXE, v4.11
  1021.  
  1022.    Search Strings:  COMMAND FILE, ESC COMMANDS, FOOTER, HEADER
  1023.  
  1024.    Problem Fixed by This Patch:
  1025.  
  1026.    When a report contains a header or footer, MAKE_XTA does not place the
  1027.    correct number of .ESC. commands in the command file.  As a result, the
  1028.    command file does not replay correctly in Xtrieve.  This patch ensures that
  1029.    MAKE_XTA places the correct number of .ESC. commands in the command file
  1030.    for report headers and footers.
  1031.  
  1032.    * * * * * * * * *
  1033.  
  1034.    Product/Platform:  OS/2 - XCFP.EXE, v4.11
  1035.  
  1036.    Search Strings:  COMMAND FILE, FMENU COMMAND, XTA TO XTC CONVERSION
  1037.  
  1038.    Problem Fixed by This Patch:
  1039.  
  1040.    When XCFP converts an .XTA file containing an .FMENU. command to an .XTC
  1041.    file, XCFP does not place the commands in the command file.    This patch
  1042.    ensures that XCFP correctly interprets an .FMENU. command and includes it
  1043.    correctly in the .XTC file.
  1044.  
  1045.    * * * * * * * * *
  1046.  
  1047.  
  1048. ================================================================================
  1049. Documentation Updates
  1050. =====================
  1051.  
  1052.    NOTE:  The documentation updates that follow are supplement any documentation
  1053.       updates noted in the Readme file of the original product.  Note that
  1054.       only the December 1992 patch release included such updates.
  1055.  
  1056.  
  1057. December 1992 Updates
  1058. ---------------------
  1059.  
  1060.    Note the following change to the "Xtrieve PLUS User's Manual:"
  1061.  
  1062.    -  Page A-49
  1063.       Add the following status codes:
  1064.  
  1065.       349  The Specified Data Value Is Too Large for the Field Definition
  1066.  
  1067.        The data value you specified is larger than the maximum length
  1068.        defined for the field.
  1069.  
  1070.       350  Security Has Not Been Enabled on This Dictionary
  1071.  
  1072.        You attempted an operation that can be done only when security is
  1073.        enabled.  Database security is not enabled at this time.  To perform
  1074.        the operation successfully, enable security on that database.
  1075.  
  1076.       351  A Transaction Has Not Yet Been Started
  1077.  
  1078.        You attempted to perform a COMMIT or ROLLBACK operation without being
  1079.        inside a transaction.  You must start a transaction before you can
  1080.        perform a COMMIT or ROLLBACK operation.  To start a transaction,
  1081.        issue a START TRANSACTION operation.
  1082.  
  1083.       352  Record Count Must Be Greater Than Zero
  1084.  
  1085.        NetWare SQL received a record count value for the xFetch call that is
  1086.        not more than zero.    The record count for an xFetch call must be at
  1087.        least 1.
  1088.  
  1089.  
  1090. ================================================================================
  1091.  
  1092.    Novell, Inc. has attempted to supply trademark information about company
  1093.    names, products, and services mentioned in this file.  The following list of
  1094.    trademarks was derived from various sources.
  1095.  
  1096.  
  1097.    NetWare, Novell, Btrieve, and XQL are registered trademarks of Novell, Inc.
  1098.  
  1099.    NetWare Btrieve, NetWare Loadable Module, NetWare SQL, NLM, and Xtrieve PLUS
  1100.    are trademarks of Novell, Inc.
  1101.  
  1102.    NetWire is a registered service mark of Novell, Inc.
  1103.  
  1104.    1-2-3 and Lotus are registered trademarks of Lotus Development Corporation.
  1105.  
  1106.    CompuServe is a registered trademark of CompuServe, Incorporated.
  1107.  
  1108.    OS/2 is a registered trademark of International Business Machines
  1109.    Corporation.
  1110.  
  1111.  
  1112. ** End of XTROS2.TXT **
  1113.